home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Environments / ReWrite 0.2.7 / ReWrite 0.2.7 README < prev   
Text File  |  1996-02-11  |  6KB  |  126 lines
  1. ReWrite 0.2.7       written by Roy Ward
  2.  
  3. 11th Jan 1996
  4.  
  5. Any changes or additions to the ReWrite 0.2.6 README are labelled in blue.
  6.  
  7.     ReWrite is a programming language (still in its development stages) for the Macintosh using a rewrite rules syntax. See the documentation for details.
  8.  
  9. This file has the following sections:
  10.     • Files
  11.     • Hardware/System requirements
  12.     • Using ReWrite off a CD
  13.     • Documentation
  14.     • Versions and changes
  15.     • Let me know
  16.     • Announcement mailing list
  17.     • Contact information
  18.     • Credits
  19.     • Version History
  20.     • Copyright stuff
  21.  
  22. Files
  23.  
  24. This file should be part of a folder containing the following:
  25.     This README file
  26.   ReWrite 0.2.7                          (the application)
  27.   ReWrite 0.2.7 Docs                  (an eDOC document)
  28.   eDOC Reader
  29.   Sample Project
  30.  
  31. Sample Project should contain the following files:
  32. 0Project    r.setup    r.go    l.setup    l.go
  33.  
  34. Hardware/System requirements
  35.  
  36.     ReWrite 0.2.7 will only work on Macintoshes with a 68020 or better, and should run in emulation on PowerMacs. It requires at least 1500K to run. System 7.0 or better is also required.
  37.  
  38. Using ReWrite off a CD
  39.  
  40.     If you are running ReWrite off a CD, it is most important that the 'Sample Project' folder be copied onto a writable media such as a hard disk ßand used from there, as ReWrite assumes that it can update the object files. The ReWrite application does not modify itself, so can be left on the CD.
  41.  
  42. Documentation
  43.  
  44.     The documentation has been changed to use eDOC. It has been left as a non self-reading document and the eDOC reader included so that the copy facility of eDOC can be used. The original ClarisWorks® document is available on the web site or on request.
  45.     Colour text is used for clarity, but is not essential for making sense of the documents. Also, page and section numbering has not been used, as the documentation is subject to change.
  46.  
  47. Versions and changes
  48.  
  49.     ReWrite is a very rapidly evolving language. In the documentation I have tried to point out features that will not be supported or be different in later versions. Also, there is a lot of stuff that is undocumented that still might be useful (e.g. try 'getclipboard[]'). I make no guarantees about particular functions operating in exactly the same way in future versions, but if I make any major changes to the syntax I will endeavour to provide easy means of conversion.
  50.     One relatively recent change was the addition of new types (before there was only 'list' and 'int'). Some of the documentation (and certainly some of the functions) have not 'caught up' yet with this change. The compiler doesn't really use these types yet (any undocumented functions will store strings as lists of integers). Any type inconsistencies will be fixed in ReWrite 0.3.
  51.     There will be a new version coming out (hopefully in the next few months) that has a new project structure, a faster smaller compiler, macros and more types, but this will depend on other commitments (compiler writing is hard work). ReWrite is a personal (hobby) project - I am writing it in my spare(?) time.
  52.  
  53. Let me know
  54.  
  55.     I would like to hear from you if you use or are interested in ReWrite at all. More feedback contributes to a better language. I would also like you hear if you:
  56.     • find any bugs or have any other problems with ReWrite,
  57.     • have any suggested improvements or extensions,
  58.     • want to make any (constructive) suggestions,
  59.     • have any comments to make about the documentation,
  60.     • have any example source code you wish to contribute,
  61.     • can think of any problems that ReWrite would be well/badly suited for,
  62.     • have anything else that you want to say or ask.
  63.  
  64. Announcement mailing list
  65.  
  66.     In order to save some of my time E-mailing people seperately about developments/releases/bug-fixes etc. , I am compiling a list of people to send any announcements to (sort of a low volume one-way mailing list). Let me know if you want to be included on this list.
  67.     If you have already asked for any future info and weren't
  68. notified about this minor release, I apologise as there was a some confusion when I switched E-mail addresses. Please E-mail me and I'll add you to the list.
  69.  
  70. Contact information
  71.  
  72. Email:    roy@earthlight.co.nz
  73.  
  74. Postal address (until 30th of December, 1996):
  75.         377a Pine Hill Road,
  76.         Dunedin,
  77.         New Zealand.
  78.  
  79. Note that the postal address only applies to the end of the year; after that any mail sent to that address will not reach me.
  80.  
  81. World Wide Web pages:
  82.    http://goldfish.physics.utoronto.ca/~roy/ReWrite.html
  83.  
  84. Updates are also available on any 'info-mac' archive mirror.
  85.  
  86. Credits
  87.  
  88. I wish to thank the following people for their suggestions and encouragement:
  89.  
  90.                     Dr. Gerrard Liddell
  91.                     Dr. Tim Molteno
  92.                     Jason Harris
  93.  
  94. The user interface was written using the Object Class Libraries in THINK Pascal™, so portions of the code are Copyright © 1988-1991 Symantec™ Corporation.
  95.  
  96. Version History
  97.  
  98. • Changes to ReWrite 0.2.7
  99. * a function pointer type added, with functions such as Map, Apply,
  100. * extended documentation, including 'getting started section',
  101. * StrToSym, SymToStr functions,
  102. * More bug fixes, including a long standing bug that would cause fatal problems sometimes with the object files.
  103.  
  104. • Changes to ReWrite 0.2.6
  105. * Some bug fixes in the compiler (the bugs could cause bus errors).
  106. * Compiler doesn't try to keep going after errors any more (this was dangerous).
  107.  
  108. • Changes to ReWrite 0.2.5
  109. * Dotted variables may appear anywhere in a pattern - the following sort will now work:
  110.  
  111.   sort[{.a,b,c,.d}]::b>c -> sort[{.a,c,b,.d}];
  112.   sort[x] -> x;
  113.  
  114. Copyright stuff
  115.  
  116. ReWrite is copyright © 1994-1996 Roy Ward. All rights reserved.
  117.  
  118. ReWrite is freeware and may be distributed freely in its original form (or in its original form along with any source code written by others that is clearly labelled as such), as long as it is not distributed for profit without express permission from the author. ReWrite has been designed to be robust, but is distributed without any warranties, and in the unlikely event of ReWrite causing damage the author assumes no responsibility for any such damage.
  119.  
  120. Permission is granted to include this release of ReWrite on the following CD's:
  121.     • The Apprentice CD, by Celestin Company Inc,
  122.     • Any CD releases of (portions of) the info-mac archives released by sumex-aim.
  123.  
  124.                                     Have fun with all this,
  125.                                     Roy Ward.
  126.